home *** CD-ROM | disk | FTP | other *** search
/ Magnum One / Magnum One (Mid-American Digital) (Disc Manufacturing).iso / d11 / ega2vga3.arc / EGA2VGA3.DOC < prev    next >
Text File  |  1989-01-12  |  31KB  |  727 lines
  1.           EGA2VGA Copr. (c) 1988-89 Lawrence Gozum & Marvin Gozum
  2.           ───────────────────────────────────────────────────────
  3.  
  4.                                 User Manual
  5.  
  6.     DISCLAIMER
  7.  
  8.     This  product  is distributed AS IS.  The authors specifically disclaim
  9.     all  warranties  ,expressed  or implied, including ,but not limited to,
  10.     implied  warranties  of  merchantability  and  fitness for a particular
  11.     purpose  with respect to defects in the diskette and documentation, and
  12.     program  license  granted  herein,  in particular, and without limiting
  13.     operation  of  the  program  license  with  respect  to  any particular
  14.     application  use  or  purpose.  In no event shall the authors be liable
  15.     for  any  loss  of  profit or any other commercial damage including but
  16.     not limited to special,incidental, consequential or other damages.  
  17.  
  18.     LICENSING AGREEMENT
  19.  
  20.     You  may  use  this program on a TRIAL BASIS only;  this means that you
  21.     may  freely  evaluate  this program for a period not to exceed TEN (10)
  22.     DAYS.    Should you find this program useful, you must register it (see
  23.     last section of this manual).
  24.  
  25.     You  may  freely  distribute  copies  of this program in its UNMODIFIED
  26.     state  provided  you do not include it in other software packages, with
  27.     the  exception  of distributing it as part of a bundle of Public Domain
  28.     or  Shareware  programs  on a single diskette.  In addition you may not
  29.     charge  more that $3.50 for copying and/or distributing this program in
  30.     the absence of any recognized Users Group guidelines.
  31.  
  32.  
  33.     WHAT IS EGA2VGA ?
  34.  
  35.     EGA2VGA  is  a  conversion program that will convert ANY GIF (16 colors
  36.     and  below)  and  ANY  VIEWABLE EGA 640x350x16 (or 2) or VGA 640x480x16
  37.     (or  2) picture into a 320x200x256 color picture, WITH 256 NEW COLORS !
  38.     EGA2VGA  actually  generates  256 new colors from the original 16 color
  39.     EGA  palette  and  interprets  color mixtures.  EGA2VGA also accurately
  40.     calculates  the correct aspect ratio for translation.  Finally, EGA2VGA
  41.     saves  your  converted  screen  and palette in a 'bloadable' format for
  42.     porting to:
  43.  
  44.          (1) VGACAD for editing/image processing;
  45.          (2) BLD2GIF for reconversion to a smaller 320x200x256 GIF pic;
  46.          (3) GIFDOT for printing to an Epson/IBM compatible printer;
  47.          (4) GIFPUB for desktop publishing.
  48.  
  49.  
  50.     EGA2VGA  comes with TWO (3) TSR (Terminate and Stay Resident) utilities
  51.     called  EGADMP  (EGA  DuMP), VGADMP (VGA DuMP) and XGADMP (eXtended EGA
  52.     DuMP)  which  capture  the  raw  screen  data  of any EGA 640x350x16 or
  53.     VGA/EEGA  640x480x16  in  files EGA350SC.nnn/EGAPAL16.nnn (for EGADMP),
  54.     VGA480SC.nnn/VGAPAL16.nnn  (for VGADMP), and XGA480SC.nnn/XGAPAL16.nnn,
  55.     (for XGADMP).
  56.  
  57.  
  58.  
  59.  
  60.  
  61.  
  62.  
  63.  
  64.  
  65.  
  66.  
  67.     REQUIREMENTS
  68.  
  69.     No  Video  card  is  required.  About 512KB of free memory is required;
  70.     although,  EGA2VGA  actually  uses  about half of it.  GIF files can be
  71.     converted even if you are using CGA, Hercules or EGA cards. 
  72.  
  73.     You  MUST  have  VGA  (at  least BIOS compatible) present and an analog
  74.     monitor  to  use VGADMP.  PS/2 Model 30's that support MCGA only cannot
  75.     use  VGADMP.  VGADMP needs 307,984 of diskspce per picture.  A HardDisk
  76.     is highly recommended.
  77.  
  78.     EGADMP  requires  an  EGA  card (256KB version). EGADMP need 224,016 of
  79.     diskspace  for  each captured picture.  XGADMP requires an Extended EGA
  80.     card  (e.g.,  ATI  EGA  Wonder  800,  Quadram  Prosync EGA, Video7 Vega
  81.     Deluxe  EGA,    BOCA EGA, Paradise EGA 480, STB Auto EGA, etc ...) or a
  82.     VGA compatible card.
  83.  
  84.     EGA2VGA  needs  64KB  of diskspace to save each processed picture.  GIF
  85.     files   vary  in  their  disk  space  requirements.    For  example,  a
  86.     640x480x16  GIF  picture  will  decompose  to 307,200 bytes, while a an
  87.     EEGA  800x560x16  (e.g.,  ATI  EGA  Wonder)  will  decompose to 448,000
  88.     bytes.    The  program  will  abort creation of decomposed GIF files if
  89.     there is insufficient diskpace.
  90.  
  91.     Note:       When in DOS or using a picture viewer (e.g., PICEM, EGAGIF,
  92.               FASTGIF,  VPIC,  CSHOW, OPTIKS) or application which requires
  93.               a  keypress  to continue, it is necessary to hit any key or a
  94.               specified  key  (e.g., <Spacebar> or <Return> or <Esc>) after
  95.               hitting  the 'HOTKEY' before EGADMP or VGADMP or XGADMP saves
  96.               the screen and palette.
  97.  
  98.  
  99.     HOW TO USE EGADMP, XGADMP and VGADMP
  100.  
  101.     Simply   run   EGADMP,   XGADMP  and/or  VGADMP  before  entering  your
  102.     painting/CAD  or  digitized  picture  viewer.     After loading,  press
  103.     <ALT-F10>  for  EGADMP  or  <ALT-F9>  for  VGADMP,  while  viewing your
  104.     picture.    Your  current  screen  and  palette  will  be saved in your
  105.     default drive and directory.
  106.  
  107.     In  the case of EGADMP, the first time you run the program it will save
  108.     your    screen   and   palette   to   EGA350SC.000   and   EGAPAL16.000
  109.     respectively.    If  there is an existing EGA350SC.nnn or EGAPAL16.nnn,
  110.     then  it  will  increment  to  the  next  higher  number.   This can be
  111.     confusing  if  you  keep  unmatched  screens and palettes.  You can use
  112.     your  favorite  memory managers to remove this TSR or reboot to release
  113.     it  from  memory.    VGADMP will saves to VGA480SC.nnn and VGAPAL16.nnn
  114.     files, while XGADMP saves to XGA480SC.nnn and XGAPAL16.nnn files.
  115.  
  116.     Some  GIF  viewers  view 640x480x16 pictures in Extended EGA 640x480x16
  117.     mode.    VGADMP  WILL  NOT  SAVE  THE PALETTE DATA CORRECTLY WITH THESE
  118.     VIEWERS;  USE XGADMP INSTEAD.  VGADMP uses the DAC registers which only
  119.     come  with  VGA  cards  in Mode 12 (640x480x16 - 16 colors from 256KB).
  120.     Extended  EGA  (EEGA)  is NOT VGA !  EEGA uses only 16 colors from a 64
  121.     fixed  colors possibilities.  If your picture doesn't look right in VGA
  122.     mode then it was probably viewed in EEGA mode.
  123.  
  124.  
  125.  
  126.  
  127.  
  128.  
  129.  
  130.  
  131.  
  132.  
  133.     Dual  Floppy  users  (5.25  inch  types) have a problem.  Since the raw
  134.     pixel  dumps per file are quite large, you have save the "dumped" pixel
  135.     files in another drive.  For example:
  136.  
  137.          With  EGADMP  resident  in  memory,  TESTPIC.GIF  in  Drive A: and
  138.          viewing  program  (e.g.,  FASTGIF) in Drive A: you must switch the
  139.          default drive and view the picture from the other drive.
  140.  
  141.          1) Type "B:"<ret> to switch to Drive B: as default.
  142.          2) From Drive B: type "A:FASTGIF A:testpic.gif" <ret>.
  143.          3) Now when you hit <ALT-F10> the pixels and palette will be
  144.             "dumped" in Drive B:.
  145.  
  146.     HOW TO USE EGA2VGA
  147.  
  148.     EGA2VGA follows a 3 step process (4 with VGA/MCGA card).
  149.  
  150.     STEP 1:  Specify Input and Output files.
  151.  
  152.          a.   Select from      [E]GA  640x350x16 (captured)
  153.                                [X]EGA 640x480x16 (captured) 
  154.                                [V]GA  640x480x16 (captured)
  155.                                [G]IF NNNxNNNxNN (16 or less colors)
  156.  
  157.          b.   Press  the <Spacebar> to specify the PATH (where the "dumped"
  158.               files  are  located;    Hard  Disk  users  can  use  the same
  159.               directory   (assuming  you  have  enough  free  disk  space).
  160.               Pathnames  MUST  end  with the backslash character (i.e.,"\")
  161.               or it will be rejected.
  162.  
  163.               Examples:   "A:\" or "B:\" or "C:\GIF\EGA\"
  164.  
  165.          c.   Select  the specific file by moving the <arrow> keys over the
  166.               filename then press <return> to select that file.
  167.  
  168.               If  a  GIF  file  was  processed  previously, a TEMP.RAW file
  169.               would  have  been  created which are the decompressed pixels;
  170.               this  file  is  NOT  automatically deleted after processing a
  171.               LARGE  GIF  picture.  If you want to process the same picture
  172.               using  a  different  method (e.g., "color averaging") or want
  173.               to  zoom another part of the same picture, simply reply [Y]es
  174.               when prompted "Use TEMP.RAW ? [Y/n]".
  175.  
  176.               The  palette data and screen size dimensions are NOT retained
  177.               and  MUST be read (i.e., again) from the original GIF picture
  178.               processed.    Be  sure to remember what that GIF file was (if
  179.               you  intend  to  reuse  the  TEMP.RAW  file) or you will have
  180.               mismatched  colors and screen dimensions.  This feature saves
  181.               a  lot  of  time  since decompressing the pixels to disk is a
  182.               time  consuming  process.    use  this feature if you want to
  183.               "zoom"  another area of the picture or continue experimenting
  184.               with color generation at anothwer time.
  185.  
  186.  
  187.  
  188.  
  189.  
  190.  
  191.  
  192.  
  193.  
  194.  
  195.  
  196.  
  197.  
  198.  
  199.               Floppy  disk  and  High-density  drive  users  SHOULD  delete
  200.               TEMP.RAW  if  you  are  not going to process the same picture
  201.               again;    you  may get an error message for insufficient disk
  202.               space if you don't.
  203.  
  204.          d.   Specify  the  FILENAME  that  will  be given to the converted
  205.               picture.    If  there  is  an  existing  file  with  the same
  206.               filename(s)  then  an  error  beep will follow and your input
  207.               will  be  rejected.    DO NOT INCLUDE EXTENSION.  The program
  208.               will automatically append the extension to your files.
  209.  
  210.               Converted  files  will  be  saved  to  your DEFAULT drive and
  211.               directory  if  you  do not specify a PATH.  The following are
  212.               legal pathnames:
  213.  
  214.               Examples:        "A:\MYPIC"
  215.                                "C:\VGACAD\MYPIC"
  216.  
  217.  
  218.     STEP 2: Modify the 16 color palette (VGA required/optional)
  219.  
  220.          VGA  users  will  have  this  function  if a VGA card is detected;
  221.          otherwise, the program will skip this step.
  222.  
  223.          EGA  provides  only  16  colors from 64 hardware-generated colors;
  224.          these  are  fixed  and  cannot  be modified.  VGA/MCGA 320x200x256
  225.          mode  (Mode  13) allows 256 color from 262,144 possible colors; in
  226.          VGA  640x480x16  color  mode,  you  are allowed 16 colors from the
  227.          262,144 color selection.
  228.  
  229.          Your  captured  picture will be displayed in 640x480x16 color mode
  230.          and  will look exactly like your original EGA picture but slightly
  231.          flattened  if  the  screen  size  is less than 480.  If the Screen
  232.          Width  is  greater  than  640  pixels,  the  excess pixels will be
  233.          truncated  (e.g.,  800x600x16 GIF picture).  Don't worry about the
  234.          aspect  ratio, the main fuunction of this step is to modify the 16
  235.          color   palette;   the  program  will  adjust  the  aspect  ratios
  236.          automatically in succeeeding steps.
  237.  
  238.          Why  modify  the  16  color palette ?  EGA's 64 color selection is
  239.          quite  limited;  as  a  result you will notice that skin tones are
  240.          forced  to  shades  of  orange,  pink, yellow and red.  With VGA's
  241.          640x480x16  mode  you  can  adjust  each  of the 16 colors to more
  242.          closely  resemble  photographic  quality.    Some  pictures in VGA
  243.          640x480x16 format use the same 64 color selection of EGA as well.
  244.  
  245.          When  your  picture  will  be  in  full view and a color line will
  246.          appear  asterisks  ("*****")  representing each of the assigned 16
  247.          colors.      You  can  stop  the  display  at any time by pressing
  248.          <Esc>.    You  can  adjust  each  of  the  16  colors by using the
  249.          following keyboard commands.:
  250.  
  251.  
  252.  
  253.  
  254.  
  255.  
  256.  
  257.  
  258.  
  259.  
  260.  
  261.  
  262.  
  263.  
  264.  
  265.          a.   [SpaceBar]  -  will  cycle  through each of the 16 colors and
  266.               highlight   the   current  selected  color  with  a  "██████"
  267.               highlight block.
  268.  
  269.          b.   [R],  [G]  or  [B]  - will select the color component of your
  270.               current  color  to  be modified;  an arrow will appear beside
  271.               the RGB (Red Green Blue) value of your current color.
  272.  
  273.          c.   [+]  will increase the value of your selected color component
  274.               (R,  G or B) within the range of 0 to 63).  As you modify any
  275.               component  you will see the change in your picture and in the
  276.               highlight block.
  277.  
  278.          d.   [-]  will decrease the value of your selected color component
  279.               within the range 0 to 63.
  280.  
  281.          e.   [U]ndo  will  restore  the RGB values of the current selected
  282.               color  as  long  as you do not move on to another color to be
  283.               modified.
  284.  
  285.          f.   [Esc]  will  exit  palette modification and set your 16 color
  286.               palette.
  287.  
  288.  
  289.     STEP 3: Select Matrix Type and Color Match Cutoff
  290.  
  291.          THIS IS THE MOST IMPORTANT PART OF EGA2VGA CONVERSION !.
  292.  
  293.          Primarily,  you  are  using this utility to convert color-dithered
  294.          pictures.    These  dithers  may  be  ordered or error-distributed
  295.          (i.e.,  "random").  If dithering is ordered (i.e., 2x2 matrices or
  296.          3x3  matrices) then selecting a 2x2 matrix or 3x3 matrix type will
  297.          make  a tremendous difference in color generation and avoidance of
  298.          striated  patterns.    Generally,  the  2x2  Matrix  type performs
  299.          adequately,  you  can opt for the 3x3 Matrix type for richer color
  300.          generation.  Non-VGA/MCGA users should use the 2x2 matrix type
  301.  
  302.          By  pressing  return  as  a  response  to  each input prompt for a
  303.          matrix  type  and  color  match cutoff, the default values will be
  304.          entered instead of your specification. 
  305.  
  306.               DEFAULT VALUES
  307.  
  308.               Color Match Cutoff: 40
  309.               Matrix Type       : 2x2 (A)
  310.  
  311.          Color  Match  Cutoff  or Cutoff (for short) determines how closely
  312.          matched  colors  must be to be generated.  If an existing color in
  313.          your  palette  is  "close"  enough  to the required color, then it
  314.          will be used; otherwise a new one is generated.
  315.  
  316.          VGA/MCGA  users  can  press <Esc> at any time while the picture is
  317.          being  generated to view the total number of new colors generated.
  318.          You  can  then  ABORT  the processing and choose a new Matrix Type
  319.          and/or  Cutoff.    All  other  video cards will show a status line
  320.          showing  the  Matrix  Type,  Cutoff, Colors generated and Lines to
  321.          Go; pressing <Esc> returns you to this step.
  322.  
  323.  
  324.  
  325.  
  326.  
  327.  
  328.  
  329.  
  330.  
  331.          While  the  picture  is  being  generated,  monitor  the number of
  332.          colors  being  generated.    If  the  processing slows down at the
  333.          start  of a few lines then your Cutoff is too low; your picture is
  334.          too  rich and new colors are being generated to fit the Cutoff you
  335.          specified.    <Esc>  to  this  step  (i.e.,  abort processing) and
  336.          reselect  a  HIGHER  Cutoff.   If you notice that the colors being
  337.          generated  are  too  few  then  decrease  the  Cutoff  to make the
  338.          program find/create more accurate colors.
  339.  
  340.          This  is  your main experimental loop; your mission is to find the
  341.          ideal  Cutoff  value  and  generate  as  many colors (255 maximum)
  342.          without  running  out  of  colors.  The picture is generated in an
  343.          interlaced  fashion  which  ensures  that  colors  are sampled and
  344.          generated from all over the screen.
  345.  
  346.          VGA/MCGA  users:  Monitor  the quality of the picture and speed of
  347.          processing;  this  will give you an indication of the colors being
  348.          generated.   Press <Esc> as many time as you want to interrupt the
  349.          processing  to  monitor  the actual number of colors generated and
  350.          go back to this step to find the optimal Cutoff.
  351.  
  352.          All  other  users,  watch the Colors generated on the status line;
  353.          if  you  generate  over  100 colors after the first 3-5 lines then
  354.          your Cutoff is too low and needs to be increased.
  355.  
  356.          If  you  run  out  of  colors  too  soon then other colors in your
  357.          picture  will have to settle for the closest match in the existing
  358.          palette.    If  you  can  generate  180-240 colors then an optimal
  359.          compromise  has  been  met.    Future  versions  will include more
  360.          elaborate algorithms and schemes.
  361.  
  362.  
  363.     PICK 'N ZOOM
  364.  
  365.     If  a VGA/MCGA card is detected, then this feature will be activated. A
  366.     "capture  box"  will appear and can be moved with <ARROW> keys (use the
  367.     <Shift-ARROW> keys to move around the screen faster.
  368.  
  369.     Pressing  the  <+>  key  increases  the size of your "capture box" (the
  370.     area  to  be  zoomed)  -  resulting  in a smaller "zooming factor", but
  371.     including  a  larger area of the picture.  Conversely, pressing the <->
  372.     key  will decrease the "capture box", resulting in larger magnification
  373.     but procesing a smaller area of the total picture.
  374.  
  375.     After  viewing  the  "zoomed picture", press <return> to save the image
  376.     or  press <Esc> to reselect and redefine the "zoomed image".  The image
  377.     will  be  saved  to  "ZOOM.BLD"  and  "ZOOM.PLT";  these  files will be
  378.     constantly overwritten; thus, you MUST rename these files later.
  379.  
  380.     The  "Pick  'N Zoom" loop is similar to the full screen conversion loop
  381.     and  follows  the  same  steps  with the additional step of selecting a
  382.     "captured area" to be zoomed.
  383.  
  384.  
  385.  
  386.  
  387.  
  388.  
  389.  
  390.  
  391.  
  392.  
  393.  
  394.  
  395.  
  396.  
  397.     FULL SCREEN CONVERSION FLOWCHART
  398.  
  399.              ╔═══════════════════════════════╗
  400.              ║   STEP 1: Input/Output Files  ║
  401.              ╚══════════════╤════════════════╝
  402.           ┌─────────────────┼──────────────────────┐
  403.           │                 │                      │
  404.           │                 ├─Display Picture <────┼────┐
  405.           │                 │ (VGA required)       │    │
  406.           │  ┌──────────────┴─────────────────┐    │    │ F
  407.           │  │   STEP 2: Palette Modification │    │    │ U
  408.           │  └──────────────┬─────────────────┘    │    │ L
  409.           │                 │ <Esc>                │    │ L  M
  410.           └─────────────────┼──────────────────────┘    │    O
  411.                             │<──────────────────────────┤ S  D
  412.                             │                           │ C  E
  413.              ┌──────────────┴─────────────────┐         │ R
  414.              │   STEP 3: Cutoff/Matrix Type   │         │ E
  415.              └──────────────┬─────────────────┘         │ E
  416.                             │ <Esc>                     │ N
  417.              ┌──────────────┴─────────────────┐         │
  418.              │   STEP 4: Conversion           ├─────────┘
  419.              └──────────────┬─────────────────┘   <Esc>
  420.                             │
  421.              ╔══════════════╧════════════════╗
  422.              ║         Save & Exit           ║ Non-VGA/MCGA users
  423.              ╚══════════════╤════════════════╝ stop here
  424.                             |
  425.                             | VGA/MCGA user optional
  426.                             | "Pick 'N Zoom" processing
  427.           ┌─────────────────┼──────────────────────┐
  428.           │                 │                      │
  429.           │                 ├─Display Picture <────┼────┐
  430.           │                 │ (VGA required)       │    │
  431.           │  ┌──────────────┴─────────────────┐    │    │
  432.           │  │   STEP a: Palette Modification │    │    │ P
  433.           │  └──────────────┬─────────────────┘    │    │ I
  434.           │                 │ <Esc>                │    │ C
  435.           └─────────────────┼──────────────────────┘    │ K
  436.                             │<──────────────────────────┤     M
  437.              ┌──────────────┴─────────────────┐         │ 'N  O
  438.              │   STEP b: Cutoff/Matrix Type   │         │     D
  439.              └──────────────┬─────────────────┘         │ Z   E
  440.                             │ <Esc>                     │ O
  441.              ┌──────────────┴─────────────────┐         │ O
  442.              │   STEP c: Pick 'N Zoom         ├─────────┤ M
  443.              └──────────────┬─────────────────┘         │
  444.                             │                     <Esc> │
  445.              ┌──────────────┴─────────────────┐         │
  446.              │   STEP d: Conversion           ├─────────┘
  447.              └──────────────┬─────────────────┘   <Esc>
  448.                             │
  449.              ╔══════════════╧═════════════════╗
  450.              ║         Save & Exit            ║
  451.              ╚════════════════════════════════╝
  452.  
  453.  
  454.  
  455.  
  456.  
  457.  
  458.  
  459.  
  460.  
  461.  
  462.  
  463.     BLOADING CONVERTED PICTURES IN BASIC
  464.  
  465.     The  following  lines  will  load  one  of  the  captured  screens from
  466.     QuickBASIC  4.0;    if you are using QuickBASIC 1.0, 2.0 or 3.0, I have
  467.     included  VGAMODE.obj which you can include in your UserLib.exe through
  468.     BUILDLIB.exe.
  469.  
  470.     VGAMODE  is  a BIOS compatible assembly routine which can call the more
  471.     exotic  graphic  modes  of  your  compatible  VGA card (e.g. 800x560x16
  472.     color  mode  of  ATI's  VGA VIP and EGA Wonder); check your user manual
  473.     for the correct hex codes.
  474.  
  475.  
  476.          USAGE:  Call VGAMODE(&H13) :    'MCGA 256 color mode
  477.          or      Call VGAMODE(mode%):    'where mode is an integer that
  478.                                          'corresponds to the videomode
  479.                                          'after translating it from HEX
  480.  
  481.          The following lines will perform just as well.
  482.  
  483.          Call VGAMODE(&H13):             'init MCGA 256 color mode
  484.          DEF SEG=&HA000:                 'point data segment to
  485.                                          'screen buffer A0000H 
  486.          Bload "MYPIC.BLD",0:            'load the screen
  487.  
  488.     WRITEPAL  is also a BIOS compatible assembly routine that writes to 256
  489.     palette  registers.    Although  its  main purpose is to facilitate the
  490.     overriding  of  the  VGA  or  MCGA  standard  palette,  since  it is an
  491.     all-purpose  BIOS  routine  it will facilitate changing the palettes of
  492.     more  exotic  screen  modes  such  as  the 640x480x256 color screens of
  493.     IBM's  8514/A  adaptor.  This function is similar to "PALETTE USING" in
  494.     QuickBASIC  with  the  major advantage of following the BIOS convention
  495.     which VGACAP captures and "bsaves" with.
  496.  
  497.          USAGE:  Call WritePal (Dseg%,Offset%)
  498.  
  499.          WHERE:    Dseg% =result of VARSEG for array storage
  500.                   Offset%=result of VARPTR for array storage
  501.  
  502.          The following lines illustrate its use.
  503.  
  504.          DIM UserPal%(769)               :' 256 colors x 3 registers=768
  505.                                          :' registers= red grn blu
  506.          Dseg%=VARSEG(UserPal(1))        :' get data segment
  507.          Offset%=VARPTR(UserPal(1))      :' get offset
  508.          DEF SEG=Dseg%                   :' override data segment
  509.          BLOAD "MYPIC.PLT",Offset%       :' bload in correct offset
  510.          Call WritePal (Dseg%,Offset%)
  511.  
  512.     Palettes  converted with EGA2VGA follow the BIOS calling for contiguous
  513.     RGB  (red  green  blue)  values  for all 256 colors.  One BIOS call can
  514.     update an entire palette with RGB values stored in this manner.
  515.  
  516.  
  517.  
  518.  
  519.  
  520.  
  521.  
  522.  
  523.  
  524.  
  525.  
  526.  
  527.  
  528.  
  529.     USING VGABLD
  530.  
  531.     The  "bloadable"  format  has several advantages.  You will notice that
  532.     the  pictures  load  INSTANTANEOUSLY  !   Bloading a screen is simply a
  533.     memory dump into your display area - crucial for presentations.
  534.  
  535.     In  addition, keeping the screen and palette separate allows you to use
  536.     one  palette  for  several  pictures or for creating special effects or
  537.     animation.    For  example,  you  can  make a picture shift from a "day
  538.     scene" to a "night scene" by simply changing the palette.
  539.  
  540.     You  need not go through the tedium of writing your own program just to
  541.     view  your  captured pictures.  VGABLD will load a picture for viewing.
  542.     Captured  screen  and  palette  MUST  have the .BLD and .PLT extensions
  543.     respectively  for  the same picture.  The BASIC source code is included
  544.     and is ready for compilation.
  545.  
  546.     If  you  want  to  convert  you  screen and palette to CompuServe's GIF
  547.     (Graphics  Interchange  Format);  download  a copy of BLD2GIF from your
  548.     local  BBS  (if  it  has  managed  to  reach your city) or register and
  549.     request  to receive it as part of your registered package and use it to
  550.     convert  the  two  files into GIF format or simply use VGACAD (v1.5 and
  551.     up) since it supports saving and loading 320x200x256 GIFs.
  552.  
  553.  
  554.     REGISTRATION
  555.  
  556.  
  557.     BONUS:    Registered   users  of  VGACAD  v1.4-1.5,  VGA2EGA  v1.0,
  558.               SQZGIF  v1.0-v1.2,  GIFPUB  v1.0-1.2, MAC2GIF v1-2 and/or
  559.               GIFDOT  v1.0-v1.2  are registered for EGA2VGA.  Copy your
  560.               REGISTER.OVL  file  into  the directory of EGA2VGA and it
  561.               will  operate  as  a registered version.  IF YOU HAVE NOT
  562.               REGISTERED  ANY OF THESE PROGRAMS, DO SO NOW; WHEN VGACAD
  563.               v1.60  IS RELEASED, THE REGISTER.OVL FILE WILL CHANGE AND
  564.               ALL  NEW RELEASES WILL REQUIRE REGISTER.V16 TO OPERATE AS
  565.               A NON-SHAREWARE VERSION.
  566.  
  567.  
  568.     For  19.95  (for  orders  outside of U.S.A. add USD $15.00) you will be
  569.     entitled  to  the  latest update of EGA2VGA and REGISTER.V16 file (when
  570.     released).    The  following programs listed below are provided (latest
  571.     copy  or  update)  to  registered  users.   As much as possible, we are
  572.     reprogramming  all  utilities  to  work  with  ANY video card; programs
  573.     that,  at  present,  work  with  ANY  video  card  are: GIFPUB, GIFPUB,
  574.     EGA2VGA  (v2.0), MAC2GIF and SQZGIF.  We intend to modify all utilities
  575.     to  have  device-independent  graphics  capabilities  (with the obvious
  576.     exception  of  VGACAD,  VGACAP,  VGA2EGA,  and  CGA2VGA).  If you are a
  577.     Hercules,  CGA or EGA user, and you upgrade to VGA, please inform us as
  578.     soon as possible so that we may send you VGA-dependent releases too.
  579.  
  580.     NEW!      3.5" disk users:  We are now supporting this format.
  581.               If you want your updates in this format, add $10.
  582.  
  583.  
  584.  
  585.  
  586.  
  587.  
  588.  
  589.  
  590.  
  591.  
  592.  
  593.  
  594.  
  595.     * Device-independent utilities
  596.  
  597.          GIFPUB  -  converts  256 color GIFs to B&W images of varying sizes
  598.          for  desktop publishing/printing as .PCX (ZSoft format for Ventura
  599.          Desk  Top  Publisher,  First Publisher, Publisher's Paintbrush, PC
  600.          Paintbrush+)  or  rename  files  to  .PCC  for  importing in Aldus
  601.          Pagemaker.
  602.  
  603.          GIFDOT  -  converts  256 color GIFs to B&W images of varying sizes
  604.          for  printing  on  IBM  and  Epson  compatible  printers (separate
  605.          drivers).    Several  print  sizes  with  perfect  aspect  ratios.
  606.          Variable  Brightness  and  Contrast  Stretching.  Single or Double
  607.          pass printing.  Histogram Analysis.
  608.  
  609.          SQZGIF  -  converts  LARGE  GIF  pictures (up to 2048x2048x256) to
  610.          320x200x256  using  interpolation and "color averaging" techniques
  611.          to  blend/smooth  "jaggies"  inherent in reducing LARGE GIFS while
  612.          retaining  a  maximum  of  color  information.  Version 1.2 is now
  613.          300% FASTER and features the same user interface.
  614.  
  615.          MAC2GIF  -  converts .MAC ("readmac") pictures to 5-16 grey shades
  616.          or  color  and  saves  results  as .GIF or BLD/PLT file, and other
  617.          formats;  graphics  are  viewable  in  VGA, MCGA or EGA - no video
  618.          card is required for direct Black & White conversion to GIF.
  619.  
  620.  
  621.     * Device-dependent utilities/applications
  622.  
  623.          VGA2EGA  - conversion utility to convert 256 color pictures to EGA
  624.          or  Extended  EGA picture with "35" grey shades or any combination
  625.          of  42,875  COLORS  for  the  BEST possible rendition of 256 color
  626.          pictures on an EGA/Extended EGA system.
  627.  
  628.          VGACAD  -  extensive  paint/image  processing program for VGA/MCGA
  629.          users;      v1.50   features  extensive  paintingcapabilities,  an
  630.          integrated   GIF  interface,  Airbrushes,  color  and  grey  image
  631.          processing  functions (smoothing, noise removal, shading, contrast
  632.          stertching,  edge  detection,  high frequency-boosting, ... more),
  633.          Bezier/spline  curves,  multi-featured Cut&Paste, variable sizing,
  634.          multi-directiona   256-color   gradient  fills,  256  color  16x16
  635.          pattern fills, and a LOT of other 256-color capabilities.
  636.  
  637.  
  638.     Whats next ?
  639.  
  640.     SYNPCX  is  utility  to convert dithered, monochrome .PCX (Zsoft) files
  641.     to  smooth  grey  shades.This  utility is primarily designed to convert
  642.     scanned  Black  &  White  images,  saved  to a .PCX file, for use image
  643.     processing  with  VGACAD,  redithering/resizing  with  GIFPUB, printing
  644.     with  GIFDOT,  or EGA conversion with VGA2EGA.  SYNPCX will be graphics
  645.     device independent (No Video Required).
  646.  
  647.     VGA2EGA   is   being   "turbo-charged"   in   speed  and  will  feature
  648.     Floyd-Steinberg   error-distributed  dithering  of  EGA  colors  for  a
  649.     standardized  16-color  picture resulting in excellent detail retention
  650.     and,  virtually,  standardized viewing on any EGA/EEGA system, with the
  651.     greatest possible number of colors "viewable".
  652.  
  653.  
  654.  
  655.  
  656.  
  657.  
  658.  
  659.  
  660.  
  661.     On  the  longer term, you can expect radical changes in VGACAD.  We are
  662.     also,  developing VGASHW (a 256-color presentation system), VGACBT (the
  663.     PROGRAMMABLE   Computer-Based   Training  counterpart  of  VGASHW)  AND
  664.     MANNEQUIN  (what "Weird Science" tried to do in the movie it will do on
  665.     the  computer  screen  with  potential applications for Advertising and
  666.     Fashion Design, aside from creating your own artistic nudes).
  667.  
  668.     If  you  support  maverick authors like us, we will continue to develop
  669.     innovative  products  like  nothing  seen commercially - otherwise they
  670.     will,  as  many (sigh!) good Shareware programs, simply "DIE" from lack
  671.     of  support  !    Compare the cost/benefit ratio of any of our products
  672.     with   commercial   products;   we  want  to  continue  supporting  and
  673.     developing   these   products.     Please  support  the  User-Supported
  674.     (Shareware)  concept;  you, and you alone, determine whether it will be
  675.     worthwhile to continue developing.
  676.  
  677.     To register, send in the registration form and check payable to
  678.  
  679.                              Dr. Marvin Gozum
  680.                       2 Independence Place Apt. 303-2
  681.                             6th & Locust Street
  682.                           Philadelphia, PA 19106
  683.  
  684.  
  685.  
  686.  
  687.  
  688.  
  689.  
  690.     ───────────────────────────────────────────────────────
  691.     Graphics Interchange Format and GIF are trademarks (tm)
  692.     of CompuServe Inc. an H&R Block Company. 
  693.  
  694.  
  695.  
  696.  
  697.  
  698.  
  699.  
  700.  
  701.  
  702.  
  703.  
  704.  
  705.  
  706.  
  707.  
  708.  
  709.  
  710.  
  711.  
  712.  
  713.  
  714.  
  715.  
  716.  
  717.  
  718.  
  719.  
  720.  
  721.  
  722.  
  723.  
  724.  
  725.  
  726.  
  727.